home *** CD-ROM | disk | FTP | other *** search
/ Aminet 32 / Aminet 32 (1999)(Schatztruhe)[!][Aug 1999].iso / Aminet / biz / dopus / HTTPlister.lha / HTTPlister.readme < prev    next >
Text File  |  1999-05-17  |  7KB  |  192 lines
  1.   *** Readme for setup & running of HTTPlister.rexx V2.01 ***
  2.  
  3. V2.01 changes:
  4.  
  5.    Small change to buttons to allow for the downloading of the readme
  6.    along with each file (by selecting 'Download Selected' with the right
  7.    mouse button).
  8.  
  9.    Fixed a slight incompatibility problem between the older and newer
  10.    versions of Dopus, in the handling of the search requester, thanks to
  11.    Mark for pointing it out also.
  12.  
  13.    After I found HTTPlister.rexx wouldn't work with HTTPresume V1.6 as it
  14.    would with V1.3 I've changed the port handling of HTTPresume.
  15.  
  16.    To facilitate the change from V2.0 of HTTPlister.rexx to V2.01..
  17.    
  18.    Copy the file in the drawer Buttons TO DOpus5:Buttons/
  19.    Copy the file in the drawer ARexx   TO DOpus5:ARexx/
  20.  
  21.    If SETTING UP FOR THE FIRST TIME or changing from earlier versions go
  22.    to the 'Setting up' section below.
  23.  
  24.             -------------------------------
  25.  
  26.                 Brief Description
  27.  
  28.   You will need HTTPResume, also found on aminet (comm/www) for
  29.   this to work.
  30.   
  31.   Once you have done the small amount of setting up outlined below
  32.   you will be able to list the entire contents of the Aminet RECENT
  33.   file in a Dopus lister (optionally minus the aminet file dirs you
  34.   don't want listed) and to select any number of files and download
  35.   them.
  36.   
  37.   You'll also be able to select/download and read readme files.
  38.   
  39.             -------------------------------
  40.  
  41. To get this going, pass a listing file to this script by either selecting
  42.    the listing (RECENT) file in a lister and then run this script OR pass
  43.    the listing file with it's path to this script as an argument when
  44.    running it.
  45.  
  46.    When you've finished with a listing you can get another listing into
  47.    the lister by Drag & Drop or run this script again passing the listing 
  48.    file to it as mentioned.
  49.  
  50.    When you run this script from a Dopus menu etc. set the flag
  51.     Run asynchronously.
  52.  
  53. Downloading files.,
  54.    The initial download directory is RAM: as set by the variable 'DDir'.
  55.  
  56.    You download the files by clicking on them once in the lister and
  57.    then selecting the 'Download Selected' button, selecting this button
  58.    with the right mouse button causes the .readme for each file to be
  59.    down loaded also.
  60.  
  61.    Alternatively you can Drag & Drop them into a destination lister.
  62.    That will cause that lister to be the new download directory.
  63.  
  64.    The URL for downloading files from can be changed by selecting the
  65.    'Change URL' button, the URL is shown briefly in the listers' drag bar.
  66.    Selecting this button with the right mouse button shows the current URL.
  67.  
  68.    Because the most likely time to encounter download troubles is
  69.    during the downloading of large files with the posibility of
  70.    missing the smaller files, the selected files are downloaded from
  71.    smallest to largest.
  72.  
  73.    Downloaded files of the same name overwrite the ones in the
  74.    download directory.
  75.  
  76.    An HTTPdebug.log file is written to the download directory.
  77.  
  78. Readme files.,
  79.    To read the .readme for a file hold down the SHIFT key and
  80.    DOUBLECLICK the file.
  81.  
  82.    Or hold down the SHIFT and Drag & Drop the file into a destination
  83.    lister, that will also make that lister the current download
  84.    directory - all future downloads will go there; that is until
  85.    there's another Drag & Drop to somewhere else.
  86.  
  87.    Only get ONE readme file at a time.
  88.  
  89. The lister.,
  90.    Each button in the lister has a keyboard alternative as per the
  91.    under-scored character in the text of each button plus the control
  92.    key as the qualifier.
  93.  
  94.    By selecting either of the listers column labels 'Name' or 'Comment'
  95.    the list can be sorted either by file name or by aminet directory.
  96.  
  97.    Selecting the 'Date' label in the lister gets all the lines sorted in
  98.    the same order as they were in the file they came from. (The 'dates'
  99.    are meaningless - generated for sorting purposes only).
  100.  
  101.    It is actually the 'time' part of the date field that gets incremented,
  102.    the dates remain constant.
  103.  
  104.    There are 3 sorting methods for the Date field, select the 'Date' label
  105.    3 times to see which one you want.
  106.  
  107.    o The most downloaded files from Aminet during the week have the date:
  108.      22-Feb-88.
  109.  
  110.    o The highest rated programs during the week have the date:
  111.      30-Mar-98.
  112.  
  113.    o The rest have the date:
  114.      01-Jan-78.
  115.  
  116.    Message of the day, if there is one, gets displayed as the list is loaded.
  117.  
  118.                        ---------------------
  119.  
  120.                          The Buttons
  121.  
  122.    Download:  Downloads the selected files.
  123.    Selected:  Right MB downloads file .readme's as well.
  124.            
  125.    UnSelect:  Toggles between Selected & UnSelected.
  126.    ReSelect:
  127.  
  128.    Search:    Searches Name & Comment columns for some text.
  129.    Lister:
  130.  
  131.    PreSelect: This is handy for choosing files while off line and having them
  132.               re-selected automatically when the RECENT file is loaded again.
  133.  
  134.               Clicking this button saves the names of the selected files for
  135.               re-selection when the RECENT file is again loaded into the lister.
  136.               Only when ALL the PreSelected file names are re-selected is the
  137.               PreSelected memory of the file names removed. So that if a
  138.               different RECENT  file is  loaded in  with only  some  of the
  139.               PreSelected file names in it they will still be selected but the
  140.               memory of all the PreSelected names will still be there for when
  141.               the original RECENT file is loaded into the lister.
  142.               Clicking PreSelect again during the same session (WITHOUT any files
  143.               currently selected) re-selects the PreSelected files.
  144.  
  145.    Download:  Downloads and loads (into the lister) a RECENT file from the
  146.     RECENT :  current URL.
  147.  
  148.    Change:    Changes URL and briefly displays it in the window title bar.
  149.      URL :    Right Mouse button on this shows the current URL.
  150.  
  151.                        ---------------------
  152.  
  153.    Downloaded (read) readme's are left in the download directory.
  154.  
  155.    The download directory changes when you download by Drag & Drop.
  156.  
  157.    Files not found (except the readme's) are left selected.
  158.  
  159.    If HTTPresume is aborted before the file has finished being downloaded
  160.    you will just have to try again or use HTTPresume for what it was
  161.    designed for. Read HTTPresume docs for all about that.
  162.  
  163.  
  164. *** Setting up **
  165.   
  166.   o  Copy the file in the  Button drawer to the Dopus5:Button drawer.
  167.   o  Copy the files in the Image  drawer to the Dopus5:Image drawer.
  168.   o  Copy the file in the  ARexx  drawer to the Dopus5:ARexx drawer.
  169.  
  170.   o  READ THE HEADER IN HTTPlister.rexx for more info as THERE ARE
  171.      VARIABLE VALUES TO BE SET there.
  172.  
  173.   o  Edit the FilterOut string in HTTPlister.rexx.. for the aminet
  174.      file dirs you DON'T want listed.
  175.  
  176.   I have included the file 'aminet_TREE' in this archive to refer to
  177.   when compiling the list of aminet file dirs to filter out.
  178.  
  179.   I have also included the ARexx script 'YAM2HTTPlister.rexx' for getting
  180.   a subscribed RECENT file loaded into the lister from YAM.
  181.   
  182. Note!
  183.  * This is strictly USE AT YOUR OWN RISK.
  184.  * This has only been tested with Directory Opus 5.661 Magellan and
  185.  * HTTPResume 1.6.
  186.  * The names listed in the lister are only pseudo-files and can't be
  187.  * treated as you would other file names in normal listers. Only apply
  188.  * the actions that I outline and it should all work OK.
  189.   
  190. Enjoy.
  191.                              ******
  192.